home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / basic / dialogic.zip / README < prev    next >
Text File  |  1990-01-31  |  9KB  |  247 lines
  1. Dialog Software
  2. Box 9889                     
  3. 1101 Wilson Boulevard        
  4. Arlington, Virginia 22209-0889
  5. (703) 528-1505
  6.  
  7. DiaLogic
  8. README
  9. ========
  10.  
  11. Please read this entire file.  In addition to providing changes to
  12. the User's manual, it contains other important information which
  13. will help you enjoy DiaLogic.
  14.  
  15. --------------------------------------------------------------------------
  16.  
  17. 1/29/90
  18.  
  19. SEND US YOUR TEMPLATES!
  20.  
  21. Dialog Software plans to offer a DiaLogic Template Pack in early July,
  22. 1990.  This package will be comprised of pre-tested and pre-made
  23. DiaLogic Templates and will serve as ready-to-use subprograms.  Already
  24. we have a full-function File Load dialog box which works just like
  25. the one in QuickBASIC 4.5!  We also have a screen color setting dialog
  26. box.  These templates will require DiaLogic, and can be used right
  27. out-of-the-box as subprograms.  Full documentation will be provided.
  28.  
  29. We will pay $25.00 for each contribution to the DiaLogic Template Pack
  30. which is actually used.  A contribution is an operative subprogram which
  31. makes use of DiaLogic and can provide some generic or useful function.
  32. In addition, the author(s) will be given full credit and will be honored
  33. in the product documentation. 
  34.  
  35. Please send contributions to us at the address above via US mail.
  36.  
  37. NOTE: In the event of duplicate or similar entries, the earliest or
  38.       best implementation will be used.  Please understand that we
  39.       cannot return materials sent to us and any materials sent
  40.       become the property of Dialog Software.
  41.  
  42.  
  43. --------------------------------------------------------------------------
  44.  
  45. *  Technical Support (For Registered Users Only):
  46.  
  47.    Free technical support is available by calling Dialog Software at
  48.    (703) 528-1505.  The best time to contact a technician is in the
  49.    morning, from 8:30 a.m. to 11:30 a.m., during business days.  Beyond
  50.    these hours, technical lines are usually open until 5:30 p.m.  When
  51.    you call please leave a brief message regarding the nature of your
  52.    problem.  This way, the most appropriate technician can contact you.
  53.    In order to keep product costs low,  we must ask to return calls
  54.    collect.  If this is not possible we invite you to write to us with
  55.    your question(s) and we will respond to you by mail.
  56.  
  57. *  Special Notes:
  58.  
  59.    If you own QuickPak Professional, an extensive library of assembler
  60.    routines for QuickBASIC [available from Crescent Software
  61.    (203) 846-2500], you may experience a conflict with the MScrnSave
  62.    and MScrnRest routines.  This conflict is created because of the
  63.    DECLARE statements being used for these routines in DiaLogic.  To
  64.    fix this situation it will be necessary for you to remove the DECLARE
  65.    keyword for these two routines, and to ensure that the CALL keyword is
  66.    added to each instance of MScrnSave and MScrnRest in *every* module.
  67.    (DiaLogic uses some Crescent Software routines under a special license
  68.    with Crescent Software.)
  69.  
  70. *  Using DiaLogic:
  71.  
  72.    DiaLogic will occupy a large number of bytes when in the environment.
  73.    To help reduce the overhead caused by the lengthy comments and
  74.    formatting, we suggest that you work with a copy in which the comments
  75.    have been removed.  Another approach is to create a Quick Library
  76.    containing DiaLogic.
  77.  
  78.    When using DiaLogic, please follow these suggested tips:
  79.  
  80.       (1)   Use QuickBASIC 4.0b, if possible.
  81.       (2)   Start QB with /ah.
  82.       (3)   ALWAYS save files using the Text format.  There are
  83.             documented problems with QuickBASIC's "Fast Save" format,
  84.             such as unexplained crashes.
  85.       (4)   When compiling in the environment, always use the "Run
  86.             Restart" pulldown menu command before attempting to
  87.             Run with <Shift><F5>.
  88.       (5)   If your program breaks due to an error, go to the Immediate
  89.             Window (with <F6>) and type End.
  90.  
  91.  
  92. *  Version History:
  93.  
  94. ========
  95. 04-12-89
  96. ========
  97.  
  98.    The DiaLogic manual, after its first printing, has some minor bugs(!).
  99.    First, you should be aware that in some instances a blank page was
  100.    accidentally omitted during the printing process.  For example,
  101.    page 52 is directly opposed to the title page for Part III, where
  102.    there should have been a preceding blank page as a divider.  Do not
  103.    be concerned that pages 53 and 54 are missing, since these page numbers
  104.    were reserved for a blank divider page only.
  105.  
  106.    Second, a few minor errors were noted at this time which are summarized
  107.    below.
  108.  
  109.    We sincerely apologize for these errors.
  110.  
  111.    -----------------------------------------------------------------------
  112.  
  113.    Corrections to the manual:
  114.  
  115.       * Page 14 - In the middle of the page, the sentence should read
  116.  
  117.             "Beginning on page 27, the section . . . "
  118.  
  119.       * Page 18 - On the top of the page, second line, the sentence
  120.         should read
  121.  
  122.             "As mentioned on page 15, the . . . "
  123.  
  124.       * Page 102 - On the top of the page, fourth line, the sentence
  125.         should read
  126.  
  127.             " . . . created in Part III: Creating a Template . . . "
  128.  
  129.       * Page C-4 - The heading "Functional Problems" should be
  130.         "Operational Problems."
  131.  
  132.    -----------------------------------------------------------------------
  133.  
  134. ========
  135. 04-25-89
  136. ========
  137.  
  138.    DiaLogic is at version 1.1.  A minor adjustment was made to the ListBox
  139.    subprogram to prevent a potential Overflow error.
  140.  
  141. ========
  142. 08-03-89
  143. ========
  144.  
  145.    DiaLogic is at version 1.2.  Fixes include better keyboard control,
  146.    a correction of wrongly-returned values in one-across scrolling list
  147.    boxes, and a fix to an option button array.
  148.  
  149. ========
  150. 11-15-89
  151. ========
  152.  
  153.    DiaLogic is at version 1.3.  A fix was made to list boxes containing
  154.    only one item.
  155.  
  156. ========
  157. 01-08-90
  158. ========
  159.  
  160.    DiaLogic is at version 1.4a.  New memory allocation techniques were
  161.    created to ensure proper deallocation.
  162.  
  163. ========
  164. 01-11-90
  165. ========
  166.  
  167.    Version 1.4b
  168.  
  169.    Focus may be changed by setting the new focus and ensuring that
  170.    Action = 3.  The correct list box element is now returned when the
  171.    mouse is used while polling a list box.  Further, Action is now
  172.    set to 4 when a new list box item has been selected.
  173.  
  174. ========
  175. 01-22-90
  176. ========
  177.  
  178.    Version 1.4c
  179.  
  180.    Sentence-linked list boxes now properly erase old sentence strings.
  181.    The FIX statement was removed, and a better method of calculating
  182.    the current column in list boxes was developed.
  183.  
  184. ========
  185. 01-28-90
  186. ========
  187.  
  188.    Version 1.4d
  189.  
  190.    All items in a dialog box are now properly refreshed (i.e., updated)
  191.    to reflect new information in DB and LB when Action is set to 2.
  192.    Smart Lables are refreshed with respect to text and color.  It is
  193.    now very easy to build color-setting dialog boxes or File Load
  194.    dialog boxes by using Action 3 to poll, and Action 2 to refresh.
  195.  
  196.    NOTE: If Smart Labels are refreshed with an Action 2, please ensure that
  197.          the AltKey character for the label is not changed. 
  198.         
  199.          List boxes may be refreshed in several ways.  Many users have
  200.          requested the ability to control whether an item is highlighted,
  201.          to redraw the items in a list box, and to select a specific item
  202.          in a list box.  When Action is 2 all dialog box elements are
  203.          refreshed (excluding the Window and the Group Box).  Since each
  204.          list box may require a different refresh type, we have made use
  205.          of DB().Default and DB().SelectedColor in order to specify how
  206.          the refresh should be conducted:
  207.  
  208.          DB().Default
  209.  
  210.             When refreshing list boxes, the Default value can be positive,
  211.             zero, or negative.  If positive, the Default item in the list
  212.             box will be highlighted and/or the focus will rest on it when
  213.             the list box is accessed.  If zero, no item will be selected.
  214.             if negative,  the contents of the list box are entirely redis-
  215.             played.  The absolute value of the negative default become